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METHODS, SYSTEMS AND COMPUTER PROGRAM PRODUCTS FOR 
COUPLING ELECTRONIC MAIL AND RELATIONAL DATABASE 
FUNCTIONS 



Field of the Invention 

The present invention relates to electronic mail (e-mail) and, more 
5 particulary, to the generation of e-mail. 

Background of the Invention 

In electronic business (e-business), where typically several companies may 
provide similar goods or services, loyalty of customers maybe important in the 

1 0 success of a business. Such loyalty may, for example, be gained by being 

responsive to customers and by maintaining contact with customers on an ongoing 
basis. On tool for customer outreach and relationship building is electronic mail 
(e-mail). In fact, customer feedback (such as registration thank-you notes, target 
marketing offers, and order status updates) can become a positive market 

15 differentiator. 

In such an environment, speed, efficiency, and responsiveness may be 
important to success. Therefore, e-mail outreach to customers should be 
accomplished in a timely manner and, preferably, as efficiently as possible. 
Accordingly, the quality of the business process implementation can be just as 

20 important as the content of the e-mail message itself Thus, a need exists for 
efficient e-mail message generation suitable for use, for example, in e-business. 
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Summary of the Invention 

Embodiments of the present invention provide methods, systems and 
computer program products for generating an electronic mail message by 
automatically generating an electronic mail message responsive to an action being 
5 performed on a database entry. In particular embodiments of the present invention, 
performance of an action on the entry in the database is detected and a user defined 
function (UDF) of the database triggered which provides access to an electronic 
mail system. The UDF is triggered in response to the detection of performance of 
the action on the entry. The electronic mail system is accessed utilizing the UDF 

1 0 to generate the electronic mail message responsive to the UDF being triggered. 

In further embodiments of the present invention, detecting performance of 
the action and triggering a user defined fimction may be provided by establishing a 
database trigger associated with entries in the database which activates the UDF 
upon an action being performed on the entries associated with the trigger. 

1 5 Furthermore, the UDF may obtain electronic mail information associated with the 
entry in the database and provide the electronic mail information to an application 
program interface for the electronic mail system. Such an application program 
interface may provide abstract layering for the underlying electronic mail system. 
Also, the UDF may have a first class which obtains the electronic mail information 

20 and a second class which provides the electronic mail message information to the 
electronic mail system. 

In particular embodiments of the present invention, the application program 
interface may be the JavaMail Application Program Interface. Furthermore, the 
action performed on the database entry which causes the trigger to be activated 

25 may be an insertion of the entry into the database. In certain embodiments of the 
present invention, the database is a DB2 database. Also, the electronic mail system 
may execute on a data processing system remote from a data processing system on 
which the database executes. 

As will further be appreciated by those of skill in the art, while described 

30 above primarily with reference to method aspects, the present invention may be 
embodied as methods, apparatus/systems and/or computer program products. 
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Brief Description of the Drawings 

Figure 1 is a block diagram illustrating a system incorporating 
embodiments of the present invention; 

Figure 2 is a block diagram of a data processing system according to 
embodiments of the present invention; 

Figure 3 is a more detailed block diagram of a data processing system 
according to embodiments of the present invention; 

Figure 4 is a flowchart illustrating operations according to embodiments of 
the present invention; and 

Figure 5 is a flowchart illustrating operations according to further 
embodiments of the present invention. 

Detailed Description of tiie Invention 

The present invention now will be described more fully hereinafter with 
reference to the accompanying drawings, in which illustrative embodiments of the 
invention are shown. This invention may, however, be embodied in many different 
forms and should not be construed as limited to the embodiments set forth herein; 
rather, these embodiments are provided so that this disclosure will be thorough and 
complete, and will fully convey the scope of the invention to those skilled in the 
art. 

As will be appreciated by one of skill in the art, the present invention may 
be embodied as a method, data processing system, or computer program product. 
Accordingly, the present invention may take the form of an entirely hardware 
embodiment, an entirely software embodiment or an embodiment combining 
software and hardware aspects all generally referred to herein as a "circuit" or 
"module." Furthermore, the present invention may take the form of a computer 
program product on a computer-usable storage medium having computer-usable 
program code embodied in the medium. Any suitable computer readable medium 
may be utilized including hard disks, CD-ROMs, optical storage devices, a 
transmission media such as those supporting the Internet or an intranet, or 
magnetic storage devices. 
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Computer program code for carrying out operations of the present invention 
may be written in an object oriented programming language such as Java®, 
Smalltalk or C++. However, the computer program code for carrying out 
operations of the present invention may also be written in conventional procedural 
5 programming languages, such as the "C" programming language. The program 
code may execute entirely on the user's computer, partly on the user's computer, as 
a stand-alone software package, partly on the user's computer and partly on a 
remote computer or entirely on the remote computer. In the latter scenario, the 
remote computer may be connected to the user's computer through a local area 
1 0 network (LAN) or a wide area network (WAN), or the coimection may be made to 
an external computer (for example, through the hitemet using an Mtemet Service 
Provider). 

The present invention is described below with reference to flowchart 
illustrations and/or block diagrams of methods, apparatus (systems) and computer 

15 program products according to embodiments of the invention. It will be 

understood that each block of the flowchart illustrations and/or block diagrams, 
and combinations of blocks in the flowchart illustrations and/or block diagrams, 
can be implemented by computer program instructions. These computer program 
instructions may be provided to a processor of a general purpose computer, special 

20 purpose computer, or other programmable data processing apparatus to produce a 
machine, such that the instructions, which execute via the processor of the 
computer or other programmable data processing apparatus, create means for 
implementing the functions/acts specified in the flowchart and/or block diagram 
block or blocks. 

25 These computer program instructions may also be stored in a computer- 

readable memory that can direct a computer or other programmable data 
processing apparatus to function in a particular manner, such that the instructions 
stored in the computer-readable memory produce an article of manufacture 
including instruction means which implement the function/act specified in the 

30 flowchart and/or block diagram block or blocks. 
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The computer program instructions may also be loaded onto a computer or 
other programmable data processing apparatus to cause a series of operational steps 
to be performed on the computer or other programmable apparatus to produce a 
computer implemented process such that the instructions which execute on the 
5 computer or other programmable apparatus provide steps for implementing the 
functions/acts specified in the flowchart and/or block diagram block or blocks. 

Various embodiments of the present invention will now be described with 
reference to the figures. Figure 1 illustrates a system for e-mail generation 
according to embodiments of the present invention. As seen in Figure 1, a 
10 database server 10 includes a database 12 and a user defined function (UDF) 14 
which provides abstract layering for underlying electronic mail services, such as 
the e-mails service 16 provided by the e-mail server 18. When input is received by 
the database 12 which causes an action to be performed on an entry in the database 
12, a database trigger of the database 12 invokes the e-mail user defined fimction 
15 14. The user defined Jfunction 14 instructs the e-mail service 16 to send an e-mail 
message as a result of the action on the entry in the database 12. 

As described above, embodiments of the present invention may use a 
database UDF to provide automatic generation of e-mails, hi a relational database, 
UDFs can help streamline e-business operations. UDFs may facilitate close 
20 integration of object/relational database system function and e-business processes. 
With UDFs, processes may be closely intergrated, data integrity may be ensured, 
and/or costly application programming and reprogramming may be avoided. In 
addition, UDFs and other elements of server-side logic (such as stored procedures) 
may minimize the amount of network traffic necessary to accomplish a piece of 
25 work, resulting in higher performance. 

While embodiments of the present invention are described herein with 
reference to Figure 1, as will be appreciated by those of skill in the art in light of 
the present disclosure, the present invention may be utilized in other 
configurations. For example, while the e-mail server 18 and database server 10 are 
30 illustrated as separate data processing systems in Figure 1, they could be combined 
onto a single data processing system. Furthermore, multiple data processing 
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systems could be provided for either the database server 10 and/or the e-mail server 
18. Accordingly, embodiments of the present invention should not be construed as 
limited to the configuration illustrated in Figure 1 as the present invention 
encompasses any configuration capable of carrying out the operations described 
5 herein. 

Figure 2 illustrates an exemplary embodiment of a data processing system 
230 suitable in accordance with embodiments of the present invention. The data 
processing system 230 typically includes input device(s) 232 such as a keyboard or 
keypad, a display 234, and a memory 236 that communicate with a processor 238. 

10 The data processing system 230 may further include a speaker 244, and an I/O data 
port(s) 246 that also communicate with the processor 238. The I/O data ports 246 
can be used to transfer information between the data processing system 230 and 
another computer system or a network. These components may be conventional 
components such as those used in many conventional data processing systems 

1 5 which may be configured to operate as described herein. 

Figure 3 is a block diagram of data processing systems that illustrates 
systems, methods, and computer program products in accordance with 
embodiments of the present invention. The processor 238 communicates with the 
memory 236 via an address/data bus 348. The processor 238 can be any 

20 commercially available or custom microprocessor. The memory 236 is 

representative of the overall hierarchy of memory devices containing the software 
and data used to implement the functionality of the data processing system 230. 
The memory 236 can include, but is not limited to, the following types of devices: 
cache, ROM, PROM, EPROM, EEPROM, flash memory, SRAM, and DRAM. 

25 As shown in Figure 3, the memory 236 may include several categories of 

software and data used in the data processing system 230: the operating system 
352; the application programs 354; the input/output (I/O) device drivers 358; and 
the data 356. As will be appreciated by those of skill in the art, the operating 
system 352 may be any operating system suitable for use with a data processing 

30 system, such as OS/2, AIX or System390 from International Business Machines 
Corporation, Armonk, NY, Windows95, Windows98 or WindowsZOOO from 
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Microsoft Corporation, Redmond, WA, Unix or Linux configured to support an 
TCP/IP-based protocol connection. The I/O device drivers 358 typically include 
software routines accessed through the operating system 352 by the application 
programs 354 to communicate with devices such as the I/O data port(s) 246, the 
5 data storage 235 and certain memory 236 components. The application programs 
354 are illustrative of the programs that implement the various features of the data 
processing system 230 and preferably include at least one application which 
supports operations according to embodiments of the present invention. Finally, 
the data 356 represents the static and dynamic data used by the application 

1 0 programs 354, the operating system 352, the I/O device drivers 358, and other 
software programs that may reside in the memory 236. 

As is further seen in Figure 3, the application programs 354 may include a 
database with e-mail UDF 360. The database with e-mail UDF 360 may carry out 
the operations described herein for generation of e-mails in response to an action 

1 5 being performed on an entry in the database. The data portion 356 of memory 236, 
as shown in the embodiments of Figure 3, may include database tables 364. 

While the present invention is illustrated, for example, with reference to a 
particular configuration in Figure 3, as will be appreciated by those of skill in the 
art, other configurations may also be utilized while still benefitting fi-om the 

20 teachings of the present invention. Thus, the present invention should not be 

construed as limited to the configuration of Figure 3 but is intended to encompass 
any configuration capable of carrying out the operations described herein. 

Operations according to embodiments of the present invention, will now be 
described with reference to the exemplary network diagram of Figure 1 and the 

25 flowcharts of Figures 4 and 5. As seen in Figure 4, the database 12 receives 
input requesting performance of an action on a database entry (block 400). Such 
an action may, for example, be creation of an entry (e.g. insertion of a row in a 
database table), deletion of an entry or modification of an entry. Performance of 
the action on the database entry causes a database trigger to invoke the e-mail user 

30 defined function (UDF) 14 (block 405). The UDF 14 obtains information about 
the e-mail message to generate, such as the recipient, message content and the like, 
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which are associated with the entry on which the action was performed and/or with 
the action performed (block 410). The UDF 14 sends the e-mail information to the 
e-mail service 16 to cause the e-mail message to be sent (block 415). 

Figure 5 is a flowchart illustrating operations according to further 
5 embodiments of the present invention. Figure 5 will be described with reference 
to a particular example of the present invention as a program for a Web registration 
process that takes client-supplied information, stores it in DB2 Universal Database 
(UDB), then sends an appropriate e-mail (such as a thank you note or marketing 
offer) in response. Li the present example, when a customer visits a Web site and 
10 registers to receive additional information, a Sendmail UDF trigger fires when the 
registration is complete. Using the personal details the customer volunteered, the 
Sendmail UDF composes an appropriate e-mail (such as a thank you or 
confirmation e-mail with additional access information), and sends it to the 
customer. 

15 In the present example, the JavaMail application programming interface 

(API) from Sun Microsystems Inc., provides a "wrapper," or abstract layering, for 
underlying mail programs and protocols. This abstract layer declares classes, 
interfaces, and abstract methods to support the mail handling functions that are 
typically provided by mail systems. Part of this abstract layering of mail system 

20 functions is implemented using Internet standards. A wrapper may allow changes 
to be made without altering the imderlying program. Instead of rewriting or 
modifying the underlying program, Java programming code may be provided that 
"wrappers" the function. By using Java Mail and the Java Application Framework 
(JAF), the existing mail infrastructure may be layered on top of so that the mail 

25 programs themselves need not be changed. If Sendmail changes or falls out of 
fashion, but the underlying protocols stay the same, the program should still work. 
If the message the UDF sends requires changing, the changes are made to the UDF, 
not the underlying mail program. In fact, a future maintenance programmer doesn't 
even have to fully understand the underlying mail program, only the Java wrapper. 

30 To provide portability, the UDF may be written in Java, however, other 

programming languages may be used. In the present example, the Java UDF uses 
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Sun's JavaMail 1 .1 .3 API and JAF vl.0.1. JavaMail makes the calls to the 
underlying transport protocol (in the present example, SMTP running on a remote 
AIX machine) and provides a common API for managing e-mail. The Java UDF 
uses the JavaMail API to send messages. The JavaMail API also provides the 
5 capability to access message stores and to compose and send messages. To achieve 
this functionality, the JavaMail API provides the four abstract classes: transport, 
message, folder, and store. When the UDF in these examples sends mail, it uses the 
message and transport classes to access services in the implementation layer. In 
the particular exemplary embodiments, an IBM RS/6000 machine provides the 

10 SMTP transport services. 

The JAF specification is a data typing and registry technology that is a 
standardized extension to the Java platform. JAF extends the Java Development 
Kit (JDK) activation framework by encapsulating access to data and instantiating 
components that correspond to mail operations on the e-mail data. The Sun 

1 5 JavaMail API and JAF may provide levels of abstraction and enhanced portability. 

Returning to Figure 5, the insertion of a new row into a database table is 
detected (block 500). A database trigger associated with the table calls the UDF 
stored in the database, passing it e-mail parameters, such as address of the 
recipient, subject, and message (block 505). The UDF itself is composed of two 

20 classes, UDFSend.class and Sender.class. The UDFSend.class receives the e-mail 
parameters and provides them to the Sender.class. Sender.class makes the call to 
SMTP services running on a remote mail server (block 510). Responsive to 
receiving the call fi-om Sender.class, the mail server sends the message (block 515). 
These operations will now be described in detail for the present exemplary 

25 embodiments. Blocks 500 and 505 describe a database trigger being activated 
when a row is inserted into a database table. Triggers in relational database 
systems define a set of actions that are activated, or triggered, by DELETE, 
INSERT, or UPDATE operations on a specified table. Triggers can be used to 
enforce data integrity and transitional business rules or, as in this example, to 

30 invoke functions that perform tasks. The Java code sample in Listing 1 (below) 
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creates a trigger named AC, which is activated after INSERT into the RTPI103. E- 

mail table. 

Listing 1 : Defining the trigger. 

// Create the e-mailUDF Trigger 
5 public static void 

registerTrigger (Connection con) throws Exception 
{ try 

{ Statement registerStmt = con.createStatement (); 

System. out.println (" Registering Java trigger: AC"); 
10 registerStmt.executeUpdate ( 

" CREATE TRIGGER RTPI103.AC " + 

" AFTER INSERT ON RTPIl 03. Email " + 

" REFERENCING NEW AS N_ROW " + 

" FOR EACH ROW MODE DB2SQL " + 
15 " BEGIN ATOMIC " + 

" VALUES (EmailUDF (N_ROW.RECEr/ER, 

N_ROW.SUBJECT, 

N_ROW.MESSAGE) ); " + 

" END "); 
20 }... 

The receiver, subject, and message values for the newly inserted row, N ROW, are 
passed to the UDF called emailUDF by the action of the trigger. 

UDFs in relational database systems are often extensions or additions to 

25 existing functions. Different types of UDFs may be provided, including column, 
table, and scalar functions. Like most fimctions, UDFs return some value. For 
example, table functions return a table and column and scalar fimctions return 
single values. In the present example, scalar functions are utilized. The code in 
Listing 2 (below) registers the external scalar UDF with DB2. The first section of 

30 the create function block illustrates how to declare the input parameters as type 
VARCHAR and the return value as type INT. The external name declaration 
defines the name of the UDF as emailUDF and the Java class associated with it as 
UDFsend class. The definition block also illustrates how to declare that the UDF 
has external action (in other words, it causes an action outside of the database 

35 system). 



Listing 2: Registering the external scalar UDF. 
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// Register the UDFs 
public static void 

registerUDFs (Connection con) throws Exception 
{ try 

5 { Statement registerStmt = con.createStatement (); 

// scalar emailUDF 

System.out.println (" Registering Java UDF: emailUDF"); 
registerStmt. executeUpdate ( 

" CREATE FUNCTION emailUDF ( VARCHAR(200), 
10 VARCHAR(200), 

VARCHAR(700) ) " + 
" RETURNS int " + 

" EXTERNAL NAME 'UDFsend! emailUDF' " + 

" LANGUAGE Java " + 
1 5 " PARAMETER STYLE JAVA " + 

" DETERMINISTIC " + 

" FENCED " + 

" NOT NULL CALL " + 

" NO SQL " + 
20 " EXTERNAL ACTION " + 

" SCRATCHPAD " + 

" FINAL CALL " + 

" ALLOW PARALLEL " + 

" NO DBINFO"); 
25 registerStmt.close (); 

} 

To use the JavaMail program and JAF with the UDF code, two classes are 
created: UDFSend.class and Sender.class. Using two separate classes may facilitate 

30 development and debugging. The UDFSend.class was called by the emailUDF 
registered in Listing 2. The UDFSend.class performs two main functions: It 
accepts input arguments, such as address, subject, and message, and passes them to 
the Sender.class. The Sender.class actually makes the calls to the mail handling 
functions residing on the remote RS/6000 machines. 

35 In the sample of the UDFSend.class code in Listing 3 (below), UDFSend 

extends UDF. In the present example, it takes the address, subject, and message 
strings as inputs and returns the string length of the message, which was used for 
program debugging. Within the try and catch block a new instance of Sender is 
created, passing it the URL of our remote mail server. While not all of the code 
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associated with UDFSend.class is illustrated, the EmailSend() and Email To() 

methods map to the Sender.class code. 

Listing 3: A sample of the UDFSend.class code. 

UDFSend.class: 
5 class UDFsend extends UDF 

{ // the emailUDF UDF 
pubHc void 

emailUDF(String input Addr, String inputSubject, 
String inputmessage, 
1 0 int outputStrLen) throws Exception 

{ try 

{ // set(4, inputmessage.lengthQ); 
Sender smtp = new Sender("xxx.yyy.zzz.com"); 
/* EmailToO */ 
15 if ( ! smtp. Em ailTo(input Addr) ) ( 

//System.out.println(" EmailTo failed"); 

System, exit(l); 

} 

/* Call EmailSendO */ 
20 if( !smtp.EmailSend(inputmessage) ) { 

System.out.println("Send Message failed"); 

System.exit(l); 

} 

// System.out.println("Sender successful"); 
25 //System.exit(0); 
} 

catch (Exception e) 

{ throw e; 

) 

30 } 

The constructor of the Sender.class that actually sends the e-mail message receives 
the "host string," which is the URL of the SMTP host. In Java, a constructor is an 
instance method with the same name as its class. There are a number of methods in 
35 Sender.class, two of which are shown in the example in Listing 4 (below). Other 
methods handle Reply To, CC, From, and Subject information. For a complete 
discussion of available methods, see Sun Microsystems's JavaMail API design 
specification. As with Listing 3, Listing 4 is an exemplary portion of the code for 
the Sender.class. Remaining portions of the code of Listing 3 and Listing 4 will be 



RSW920000080US1 



-12- 



readily apparent to those of skill in the art in light of discussion in the present 
disclosure and, therefore, will not be described further herein. 
Listing 4: Two methods in Sender.class. 

Sender.class: 
5 class Sender {... 

// Host String containing the 
// address of the smtp mail host. 
Sender(String host) { 
props = new Properties(); 
10 props.put("mail.smtp.host", host); 

session = Session.getDefaultInstance(props, null); 

session. setDebug(debug); 

message new MimeMessage(session); 

} 

15 // 

public boolean EmailTo(String emailto) { 

boolto=true; 

try { 

message.addRecipient(Message.RecipientType.TO, 
20 new IntemetAddress(emailto)); 

} catch (MessagingException mex) { 

return false; 

} 

return true; 
25 }; 

// 

public boolean EmailSend(String messageText) { 
if ( !boolto ) return false; 
if ( Iboolfrom ) return false; 
30 if ( !boolsubject ) return false; 

try 

message, sets entDate(new Date()); 
message . setText(messageText . toS tringQ) ; 
Transport.send(message); 
35 } catch (MessagingException mex) { 

return false; 
} 

return true; } 

40 The flowcharts and block diagrams of Figures 1 through 5 illustrate the 

architecture, functionality, and operation of possible implementations of systems, 
methods and computer program products for e-mail generation according to 
various embodiments of the present invention. Li this regard, each block in the 
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flow charts or block diagrams may represent a module, segment, or portion of 
code, which comprises one or more executable instructions for implementing the 
specified logical function(s). It should also be noted that, in some alternative 
implementations, the functions noted in the blocks may occur out of the order 
5 noted in the figures. For example, two blocks shown in succession may, in fact, be 
executed substantially concurrently, or the blocks may sometimes be executed in 
the reverse order, depending upon the functionality involved. It will also be 
understood that each block of the block diagrams and/or flowchart illustrations, 
and combinations of blocks in the block diagrams and/or flowchart illustrations, 

10 can be implemented by special purpose hardware-based systems which perform the 
specified functions or acts, or combinations of special purpose hardware and 
computer instructions. 

In the drawings and specification, there have been disclosed typical 
illustrative embodiments of the invention and, although specific terms are 

1 5 employed, they are used in a generic and descriptive sense only and not for 

purposes of limitation, the scope of the invention being set forth in the following 
claims. 
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